REST API

REST API

REST 的核心概念

  1. 互联网上所有可以访问的内容,都是资源。
  2. 服务器保存资源,客户端请求资源。
  3. 同一个资源,有多种表现形式。
  4. 协议本身不带有状态,通信时客户端必须通过参数,表示请求不同状态的资源。
  5. 状态转换通过HTTP动词表示。

URL 设计

URL 是资源的唯一识别符。

  • /store/1
  • /store/2
  • /store/1/employee/2

查询字符串

查询字符串表示对所请求资源的约束条件。

  • GET /zoos/1/animals?limit=10
  • GET /zoos/1/animals?limit=10&offset=10
  • GET /animals?zoo_id=1

HTTP 动词

操作 SQL方法 HTTP动词
CREATE INSERT POST
READ SELECT GET
UPDATE UPDATE PUT/PATCH
DELETE DELETE DELETE
GET /v1/stores/1234
PUT /v1/stores/1234
POST /v1/stores
DELETE /v1/stores/1234